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EXEC, including all programs and riles providec. ana ail documentation, including This 
manual, is cooyrighted by the author and all rights are reserved. It is a breacn of copyright 
to load a program into computer "memory, or otherwise to reproduce it, without the 
•permission ct the cooyright owner. Purchasers ct EXEC are hereby licensed to load it, 
provided they have purchased it outright. No one is allowed to use it ir it has been 
obtained, directly or indirectly from a lending library, or similar organisation. Copying o+" 
machine-readable material is permitted for backup purposes by the original purchaser only. 
Copying of" programs -for other users is an infringement of* the cooyright, and is illegal. Note 
also the latsr section en encapsulating CLISTs. 

EXEC is distributed on an "as is" basis, without warranty. No liability or resccnsibility is 
accected for loss of business caused, or alleged to be caused by its use. 
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EXEC 15 a disk-based command processor -for TRS-88, Model I and III, or tor Genie 1 and 2. 
It executes programs consisting of mixtures of commands, BASIC statements* and controls. 
These special programs will be called "Command Lists", or CLISTs, in the following 
documentation. They ado a new dimension to the way in which you can program anc control 
your comouter. Their intended uses are: 

i) General FILE Management. Repetitive operations on DOS files can be encapsulated into 
stored programs. 

2) Test Case Execution. Any program product will normally be run against a substantial test 
case library. Interactive products, in particular, often involve tedious and time-consuming 
checking by hand. Such tests can be largely automated using CLISTs. 

3) Timings and Benchmarks. CLISTs can automate performance testing, givinc greater 
consistency, with much less manual effort. 

4) Shop-Window Demonstrations. A CLIST can be written to drive a software or hardware 
oroduct for demonstration in a shoo, or at an exhibition, being run repeatedly, with 
intermixed comments, explanations, or sales information. 

5) Tutorials. A software prccuct can be shipped with cne or more tutorial CLISTs which 
shew the customer how the product should be run. 

The TR5D0S DO command can be used to invoke BLD files created using the BUILD 
command. This function is comparable with EIEC t but EXEC gives the following advantages: 

i) EXEC runs on Model I and Genie, whereas DO is available generally only on Model III. 

2) The CLISTs are created in the same way as BASIC programs, stored with the ASCII 
option. So they can be listed, modified, or extended, unlike BLD files. 

3) At invocation, parameters can be passed to a CLIST. 

4) A CLIST will run correctly under the BASIC environment, not just under DCS. 

5) CLISTs can prompt for and receive input during execution. 

£ CLISTs can contain almost all BASIC statements, including file I/O, PRINT, I? THEN 
ELSE, and so on. Loops and conditional operations are supported. 

7) When correct, a CLIST can be encapsulated with part of EXEC itself, to produce an module 
that can be invoked as a direct command, with parameters. 

8) CLISTs can include remarks which are optionally displayed as commentary as the program 

executes. 



EXEC does not unconditionally corrupt high memory, as DO execution does, but it IS 
necessary for the user to allocate space in memory for it to run. EXEC requires 1536 bytes 
normally, or 2560 bytes if commentary screens are used. 
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The EIHC product is the module EXEC/CMD. This module , some samole programs, and 
installation and relocation utilities are suoplied on the product disk, which does *IGT induce 
a full operating system (such as TRSDOS). The disk, is either 35-tradt (Model I), or 43-track 
(Model III), or it may be double-sided, with the two formats on the two sides. You can treat 
the product disk, as a "DATA" disk.* and if you have two or more drives* or you use a 
non-TRSDGS operating system* then you can COPY or CONVERT the files from it to your 
own system (or data) disk.. You can even CONVERT the files from a 35-track disk, to Model 
III 43-track, if necessary. 

If you have only one drive, and only THSDOS* then you should put the product disk, in drive 9 
and press reset (BOOT). Then follow the instructions to swap between the product disk.* and 
your system disk.* to install a utility called IMPORT/CMD on your system disk.. Then invoice 
IMPORT, and follow its instructions to copy some or all the files from the product disk, to 
your system disk- 



Initially you need only COPY or IMPORT the files EXEC/CMD and SAMPLE/ASC. 
out ZXZC by typing, under DOS, 



'hen try 



EXEC SAMPLE (enter) 

This will invoke the module EXEC/CMD, which will in turn load and intercret the file 
SAMPLE as a "program" consisting cf thrse DOS commands, whicn turn on the CLOCK, 
display the FREE disk, space, and set AUTO to null. 

To see what the SAMPLE CLIST looks like, enter BASIC in the normal way and tyoe LOAD 
"SAMPLE/ASC". Then LIST the loaded program. 

■8 CLOCK (CM) 
28 FREE 
38 ALTO 

As an exercise, add another command to the program, e.g. 4$ CLOCK (OFF). Save this 
modified program with the ASCII option, i.e. 

SAVE "SAM?LE/ASC\A 

New return to DOS, with CMD"S", and rerun the new SAMPLE CLIST. When you type E1ZC 
SAMPLE, the extension A5C is assumed. You can supply an explicit extension if ycu wish, 
e.g. EXEC SAMPLE/ASC, or ZXEC JOE/TXT. But the file must always be in ASCII format, 

not comcressed BASIC. 

Other samcles on the przduci disk are ACCEL^/ASC and TUTORIAL/ASC. Note that these, 
anc the examples in the text, will only run under TRSDOS. This is because the other DGS's 
SB i"™ ily have an incDm P a,tible syntax for invocation of BASIC. If ycu EXECute 
ACCEL4/ASC, it will show an example SORT program running uncomoiled, arid then compiled 
'ay £5E S ~ 4 ' and is ^ he type °* demonstr ' A ' t ^ n that could be snown at a software exhibition. 
TUTORIAL/ASC will show the type of CLIST that might be shipped with a software product. 
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PASSING PARAMETERS TD A CLIST 



Suppose ens of the repetitive operations you have to do is to create a new version or a 
program you are developing. The new version is built by DUMPing a core image. But be-fore 
doing this you also want to preserve the previous version or the program as a backup, and 
you want to delete your previous backup. The sequence is typically: 

KILL PRCG/QLD 

PBWE PR0G/G£ to PROG/OLD 

DIMP PRCG/CiD (START*..., END=...,TRA=..J 

5* n ™ ycu may have tD dD * his °Heration tor many different programs, you require to write a 
CLIST to which the string "PROG" can be passed as a parameter at execution. Let's also 
assume that the addresses in START, END, and TRA, are normally fixed, but you would like 
the option to override them if necessary. On .Model I, under TRSDOS, the CLIST to so this 
woulc pe: 

19 KILL 21/OD 

28 RENAME 91/CMD to 81/OLD 

39 DLMP 21/CMD (£TART=X / 92(7888) / ,END=X , S3{723e) / ,TRA=X / 92<7888) / ) 

21 stands for the string that is the first parameter in invocation. 32 and S3 are the second 
and third parameters. If 32 and/or (23 are null, then the string bracketed by <...> will be 
substituted instead, i.e. it's the default value. If this program" is saved as UPDATE/ASC, 
say, then invocation (under DOS) will produce the following results: 

EXEC UPDATE TEST 

will execute as 

KILL TEST/OLD 

RENAME TEST/OMD TO TEST/OLD 

Dl£P TEST/CMD (START=X' 7888 ' f END=X'7280',TRA=X' 7888 ') 

: 'TE3T" has been substituted for (21, while the default values "7eee :i and "7299" have 

reolacea (22 and (23. 

ZK UPDATE TEST ,,7388 
will execute as 



KILL TEST/OLD 

RENAME TEST/CMD TO TEST/OLD 

DLMP TEST/CMD (STAOT=X'70ae^END=X'7398',TRA=X'738n 

Note that parameters are separated by single blanks or commas, and that a null can be 
shown by „ or simply by omitting trailing parameters altogether. Up to 9 parameters can oe 

used. 
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E22C uses the convention that 25, the "zeroth" parameter, means prompt for input as the 
program runs. Actually, EXEC switches input from the stored program to the keyboarc, uo 
till the next ENTER. 3c the input can be any string, and, unlike parameters i to 9, it can 
contain blanks and commas. Also each occurrence or 30 orcmots -for fresh incut, rather than 
using the previously keyed value. So an alternative way or cooing the previous example is: 

13 KILL 2 iy OLD 

23 3ENME 21/CKO 70 31/CLO 

38 DlfcP S1/CM0 (START=X'39<73a8> / ,EKO=X'28<?238> / ,TRA=X / 28<7938>'-) 

Now the CL1ST will pause three times, for the user to input the hex values, cr null. 



MEMORY ALLOCATION FOR EXEC 



The CLISTs, (SAMFLE/A5C, UFDATE/ASC, etc.) are loaded by E1ZC itself, thrcugn an 
internal buffer^So they can ae any sice. But EXEC itself occupies memory, just under X*'69e', 
or 1536 cytes. Finding this space is the user's responsibility, and where ycu put it deoencs 
largely on the^puroose for which the EIEC program is intended. The shioped file EXEC/CMD 
is located at X'7W to X'7638', and this is suitable for running DOS command secuences 
like the examples shewn above. DOS commands normally use only memory below X79y8'', 
although the utilities like BACKUP may use the whole of available memory* ana would 
therefore destroy EXEC/CMD if they were included in an ETCEC procram. (These utilities 
normally reocot at completion, as well). 

A common use of an EIEC program is to LOAD one or more machine-code programs into hich 
memory, and then to enter BASIC, protecting memory. The default location for TJizC, 
X'73ee', is also suitable for this use, and ycu can even LOAD or HUN a BASIC procram, 
provided that program is small K5K bytes; . E.g. 

LOAD bTILl/CIM 

SASIC 

22<2> 

33<4?152> 

DErUSR=4? 152-65334 

IF '3rO"» THEN RWai/BAS' 

However, if you want to use a CLIST to drive several operations in EASIC (e.g. to HUN a 
senes^of BASIC test cases) then X'7e99 / is not a suitable address for EXEC/CMD, since any 
large BASIC program will overwrite it. Instead ycu should run EXEC at the too of memory, 
in an area that must be PROTECTED, when you enter BASIC. 

To run EXEC at the too of memory, or at any address other than X'7009', ycu must first 
RELOCATE it to that address. RELOCATE is a utility provided on the product disk. Since it 
modifies the file on which it works, make sure ycu have a backuo of EXEC/CMD ce-cr« usino 
it, in case of disk error, etc. Install EELOCATE/CMD on your system and type 

HELOCATE EXEC/CMD (enter) 

The program will tell ycu the current location of EXEC, and also its length. Subtract this 
length (or simply use 1536) from your top-cf-memcry address to get i^,e target location. 




Type in This target address in response to the prompt* in decimal, or hexadecimal orececed 
by X, (or any lower address). 

Or. a 4S-C machine, top-of-rnemcry is 65536, minus 1536 gives 64000, and this value would be 
suitable as the relocation address. It must then be used in answer tD MEMORY SIZE, when 
you enter BASIC. The following program will run under EXEC* bringing up BASIC, and 
running a test case, printing the TIME be-fore and a-fter execution: 



BASIC 
62(2) 
33<c4888) 
PRINT TIMES 
RlN'21/BAS f 
PRINT TIMES 



(protect £<£C in high aemcry) 



RUNNING CLISTS IN THE BASIC ENVIRONMENT 



Unlike DO processes, CLISTs will run in conjunction with BASIC, allowing you to initialise 
DEFUSE values, activate machine-code programs, time test cases, simulate user input, and 
so on. EXEC behaves as if it were the keyboard, delivering characters one at a time to DOS 
or BASIC. The CLIST does not load into the normal BASIC program area, so it does not get 
in the way of any BASIC program you want to run. Although a CLIST is a program, ail the 
statements in it are executed in DIRECT mode (i.e. as if keyed directly). So you can use any 
EAS1C language that would make sense in DIRECT mode. E.g. PRINT TIMES, or LFRINT 
TIMES will display the current time on the screen or the printer. IF THEN ELSE can be used, 
on parameter strings, or on BASIC variables. INPUT, READ, or RETURN, however, woulc be 
rejected, since they are not legal in DIRECT mode in BASIC. RUN 106, GOTO 100, or GGSU3 
100, will be treated as operations on line 100 of the current BASIC program. I.e. GOTO 100 
will NOT branch to line 100 of the current CLIST. FOR NEXT can be used, but only within a 
single line, as is true -for DIRECT moae. Variables can be set, and used later, but only 
within the same constraints as for keyboard commands. RUN or CLEAR will destroy all 
current values. Variable values can be read from files, but in this case the file number will 
have to be keot distinct from any used in a BASIC program, and running that orcgram may 
CLOSE the direct file. 



BRANCHING IN CLI5T5 

In crderjto allow loops in CLISTs EXEC supports a .new command* the LINE commanc. LINE n 
means GGTD n in the EXEC program. If n is not found, then the program exits. In fact LINE 
a or LINE i$ee may be used as a way to terminate an EXEC program, where d or idea* are 
non-existent lines. 

Here is the previous examole, extended to loop pound prompting for the names of test cases 
to run: 



13 3ASIC 

28 SK2) 

38 a2{i4388> 

48 DEFSTR T 

58 TESTCASE*'^ 1 

o3 I? TESTC^SE* 11 T&l LINE 1883 

78 PRINT TIMES 

S8 RUN TESTCASE+'/BAS* 

n PRINT TIMES 

198 LINE 48 



Promo t for next test case 
Quit, if finished 



Loop round for sore 



Notes. 

i) The use of a descriptive word like "TESTCASE" acts as a suitable prompt for the end 
user* since it will appear on the screen. 

2) The value of TIMES cannot be saved in a BASIC variable across the HUN statement* 
Decause HUN clears all variables. To compute the actual running time of the orcgram* TIMHS 
would either have to be saved on a file* or better PQKSd into an area of hign memory and 
retrieved with PEE£ after the HUN. 

3) li } h l t3si Drc S rarn requires keyboard input, then either this must be incorporated into 
the EXEC program itself, or better* the input should be switched "permanently"* to "the 
keyboard, using '3$ as described later. 




COMMENTARY IN CIISTS 



Remarks^-; a CLIST have an important use as "commentary" in demonstrations or tutorials, 
and EXEC supports a variety or ways in which they can be used. 

Lines starting with HEM act as true remarks, i.e. you can induce them in a C1I3T to r-m— 
you wnat tne program coes. They can only be used while running in the BASIC environment 
net under DCS, and they are displayed and ignored, exactly as REMarits are in direct moae. 

Remarks using the single quote -format are interpreted in a soecial way by EXEC. Th°y <- an 
oe used under DOS, as well as BASIC. Normally, the comment text is placed not on +he 
screen, out -n a separate comment buffer, equivalent to a second unseen scr«n. Whenever 
the program flow pauses tor keyed input, the user can press the CLEAR key to swao 
Detween the real screen, and the comment screen. Whenever he tyoes in real incut the re*i 
screen will be restored, and the input shown on that, as aocrcpriate. The net effect is that 
tne ^ea; screen shows what the user would see if he were typinc in the CLIST by hand (^us 
ms own input). The commentary screen is always available" for nel ?t explanation!" or 
instruction, but as a separate process. 

The main cations available are: 

DText on the commentary screen can remain invisible until the user presses CLEAR. 

2)The commentary screen can be forced into view, by a control code, (2!, in tne CLIST. 

3)The duration of visibility of commentary can be contriled either as a fixed ce'ay, or *y 

pause-until-ENTER. 



ii SHOil 

29 fil<2> 

33 22<4?152) 

^ 'THIS IS A CCW1ENT 

58 7ESTCASE$= , 20 1 

c9 2! 

78 etc 



Put on the cownent screen, not yet visible 
Pause for input, CLEAS will shew coraient 
Force comment screen to be visible, wait for EN7ES 



-iote that tne seccne commentary screen, if used, has to be saved in memory by EX~C> >rd 
that the memory usee for tnis immediately FOLLOWS xhs module EXEC/CMD, in cor*. This 
requires a further X'M' bytes to be set aside following EXEC t wnen you relocate ""X-". 
andwhen you set ^ protected memory. I.e. the total size of EXEC will be just under X'Ae»'i 
Cr ^L^t^S" 1 ' ca5e ' So bet ' cre Y QU trs / 3U * *he use of commentary screens, go back 
anc .i; — iCATE EXEC /CXI) to make this soace available. You will normal!^ want have 
dir-erent versions of EXEC available, since CLISTs for your own use will not use 
commentary screens, but those for tutorials will. 

Another form of comment is distinguished by a starting single quote, immediately followed 
by a oius symbol. This uses the main screen itself, clearing ii before and after the comment 
i,.a comment is displayed in LARGE CHARACTERS suitable for demonstrations. Typically 
this will oe run with controlled delays, to give time to read the comment, and the actua' 
program, out without interaction by the end-user. No extra buffer space is ne^ed -t *-* 
comment. *" .-....- 



INVOKING CLI5TS WHEN IN BASIC 



All the examples shown so tar have shewn a program thai would be invoked from DCS, e.g. 
by EXEC UPDATE parami param2. If you are already in the BASIC environment, then you can 
invoice EXEC by e.g. 

CMD'TV'EXEC UPDATE parami, param2" 

CMD"I" has the effect that the program (i.e. EXEC) is invoked under the DOS environment, 
net BASIC, and so the first line of the EXEC program must be a DOS command, not a BASIC 
statement. I.e. ALL EXEC programs . must be written as if they start in the DOS 
environment, whether or not they are invoked by 






or 



CMD'TVEXEC clist" 

Of course an EXEC program can start with the DOS command BASIC * (i.e. re-enter BASIC 
retaining the existing program). This will maintain the number of files, and memory 
protection limit, but under TRSDOS, at least, DEPUSR values need to be restored. 

As an example, suppose you have a utility called SQUEEZE, which reduces the size of BASIC 
programs by removing blanks and remarks. You want to write a CLIST, called SQUEEZE/ASC, 
which saves the original 3ASIC, and then squeezes and saves the compressed BASIC, 
printing out memory used before and after. You would load ana edit your BASIC program, 
and then invoke the CLIST from the BASIC environment with: 

CHD'IYEXEC SQUEEZE .WW 

where SQUEEZE/ASC wouid be: 



BASIC * 
2WE 'Sl/BAS' 
PRINT 38298-HEM 
CMD'IYSQUEEZE' 
PRINT 232?8-MEM 
SAVE *ei/SQU' 



Re-enter BASIC immediately 
Save original version of HYPRQG 
Display original program size 
Invoke SQUEEZE utility 
Display new program size 
Save comer essed version 




ENCAPSULATING CLISTS 



For your own use the most efficient way of using EXEC is to hold one cooy of EXEC/CHI) on 
disk., along with the seoarate CLISTs, such as UPDATE/ASC, SGUEEZE/ASC, etc. However, 
if you preoare a CLIS7 that you want to make available to a third party, either as a gift, or 
for saie, then you should follow the instructions below to produce an encaosulated 
"command" which ties the module EXEC/CMD to the program it will interpret. There are 
three reasons for doing this: 

•)It makes the program easier to invoice. E.g. instead of typing EXEC UPDATE PROG! the 
end-user only has to type UPDATE FRGGi. 

2)It is mere efficient, both in disk, space and in invocation speed. (It's LESS efficient in disk, 
space, if you have many CLISTs, because it involves storing several copies of E1EC.) 

3)It avoids ccoyright infringement. If you were to give away, or sell, UPDATS/ASC in its 
original form, then you would have also to provide the module EXEC/CMD, and this would 
contrary to the copyright concession under which Southern Software programs are 
distributed. But if you encapsulate UPDATE with EXEC, then, although you are still selling 
or giving away a part of EXEC, this will be ignored by Southern Software, and no royalties 
will be claimed. - 

For this discussion assume that EXEC loads at X7eee' to X75FF'. When you run EXEC it 
uses its first 256 bytes (X'i80') as an input buffer, destroying its own initialisation coos in 
the process. When execution has comcleted, the buffer will be intact, in core. So orovided 
your CLIST, <e.g. UPDATE/ASC) is less than 256 bytes long, it will be completely contained 
within EXEC's memory area, after EXEC has completed. 

From DOS, DUMP the core-image of EXEC, inducing the 256-byte buffer, but set the module 
entry point (the THAnsfer address) to the start of EXEC plus 256, i.e. immediately following 
the buffer. Under THSDCS the DUMP command would be e.g. 



Hocel I 
Mocei Ii; 



O'JIP UPDATE/CKD (START=X"7938 / ,E>iD=X / 75fF , ,TRA=X'7!88') 
DLMP UPDATE/CMD <STAR7=37838,END=375FF.7RA=e7iee) 



Mots that the syntax of DUMP varies between the different DGS's, so check, the one for 
your DOS. 

This new module, UPDATE/CMD, can be invoiced under DOS simply by typing UPDATE 
followed by the parameters, if any, or from under BASIC by CMD'TV UPDATE parami etc". 
You dent need to ship UPDATE/ASC, since it's encapsulated in UPDATE/CMD. 

If your CLIST is longer than 256 bytes, this simple form of encaosulaticn wont work. In this 
case run EXEC against your product CLIST, as above, and DUMP the core-image, but set the 
Transfer address to 256+5 bytes from the start of EXEC. The resulting module will open 
and read the CLIST used during encapsulation. You dent need to DUMP the buffer area, 
either, although of course that area of memory will be used, when the command runs. You 
must ship the CLIST with the command. Under THSDOS the DUMP commands would be: 



Mode] I DUMP UPDATE/CMD (S7ART=X / 7ie3 / ,END=X , 75FF%7RA=X / 7185 / ) 

Model III DUMP UPDATE/CMD (START=87:85,END=875FF,TRA=87!85) 



COMPLETE LIST G? EXEC PUNC^ID" 5 

The discussicn so -far has hopefully enabled ycu to write useful CLISTs tar a number of 
acpiicaticns.Jhis section gives a comclete summary of ail the Different functions avaiiacle 
through EZiEC f along with reasons why ycu might need to use a particular function. Many of 
the functions are cniy necessary if you write CLISTs for commercial, third party use. 

i) CLIST format. A CLIST is a "BASIC" program which must be saved in ASCII 
(uncompressed) format. If it has the extension /ASC,-then the extension can be emitted in 
the invocation. But other extensions can be used, if specified explicitly. 

2) Invocation format. A CLIST called X/ASC can be invoked by: 

EXEC X paraml param2... ( un der DOS) or 

CMD'IVEXEC X par ami paran^... 3 tyrtder BASIC). 

When encapsulated into a command, X/CMD, the invocation is: 

X par ami param2... 
CMD'iyx'parami param2...* 

The parameters are strings separated by single blanks or commas. Double blank, or double 
comma implies a null parameter. 

3) Parameter substitution. Si ... (29. The occurrence of >2n, wnere n is a digit from 1 to 9, in 
the becy of a CLIST will be replaced by the nth parameter string of invocation. 

4) Incut parameters. (28. If (28 appears in the body of a CLIST, then keyboard input is 
solicited at that point, and the keystrokes which are typed in, up to but not including the 
terminating line-end (ENTEH), are substituted in place of 28. 

5) Parameter defaults. <...>. If 2n, including 20, is followed immediately by text within < > 
brackets, and if the corresponding parameter is null, then the text within < > is substituted 
for the parameter. 

6) Continuous input. (25. If 2$ appears in the body of a CLIST, then input is switcnec to the 
keyboard* up till, but not including, the next (2 character typed. This is of value when 
running e.g. a batch of test cases for which the input is unpredictable. Use 2$ after the 
HUH statement, and instruct the operator to give control back to the CLIST by typina 2 at 
ti-ie end of the test case. (2$ should also be used where run times are being measured. "EXEC 
normally takes a significant amount of time, just ignoring unwanted keyboard pells. 2$ 
avoids this overhead. 

7) Branching in CLISTs. LINE n. Use the statement LINE n in a CLIST to branch to line 
number n. EXEC implements this by rereading the CLIST from the too (which could involve 
disk I/O) until line n is found. If line n does not exist, then the CLIST exits cleanly, 
without any error indication. 

3) Illegal BASIC. (2"...". A CLIST may contain arbitrary application Input as well as 
commands, and some characters may be illegal in BASIC. Examoles are lower-case text, a 
null line, or the ? symbol, which BASIC converts to PRINT. In these cases surround the text 
with 2" ". BASIC will treat the enclosed text as literals, and EXEC will simply ignore the 
2" and clcsina ". 




■?) Slew Keystrokes. 2+ and (2-. In a. demonstration or a tutorial it may be attractive to have 
the data characters appear slowly, as if keyed by hand. 2* in the CLIST will turn on a deiay 
of about a third o-f a second oer character, while 2- will revert to normal, i.e. full soeea. 

16) Input prompt. 21ine-end. It may be that you want a tutorial tD pause indefinitely, while 
the user reads the screen, and yet you dont want the user to enter any real input. 2 on the 
end of a line, or on a line by itself, will prompt for input, but will ignore any keystrokes 
except for CLEAR, which swaos screens, and ENTER, which lets the CLIST continue. 

ii) CLIST REMarks. A line starting with REM will be ignored (in the BASIC environment 
only), and may be used as a remark in the CLIST. 

12) Direct screen commentary. '+. A "remark" that starts with a singie quote and a plus will 
be displayed in large characters (16 oer line) on the real screen. The screen is cleared 
before and after the comment is displayed, and no control is given to the user. So normally 
you will need to add a delay (see below) before and after the comment. This is intended for 
shop-window, or exhibition use. For an effective large-character display each line snould be 
centred horizontally* and the whole message should be centred on the screen vertically, 
using down-arrow graphics. (See ACCEL4 sample CLIST). 

13) Commentary screen. Remarks that start with a singie quote but no plus will be directed 
to a second, invisible, screen buffer. This resides in memory immediately after EXEC, and is 
X'W, i.e. 1024 bytes long. Space must be made available for it, if such comments are used. 
This form of commentary is intended to be used with detailed tutorials, and has the 
advantage that the true screen is not corrupted by the commentary, which may contain help 
information, instructions? or explanation. 

14) Commentary continuation. 21ine-end. Each new single-quote comment dears the 
commentary screen by default. Since BASIC allows lines only to be 256 bytes long, this 
would restrict commentary to 256 bytes. But if you put a 2 at the end of the CLIST comment 
line, then EXEC assumes the next line is a continuation comment, i.e. it adds it to the 
screen without clearing it. The continuation line should start with a single quote, but a plus 
is not needed. 



-^ 



15) CLEAR '^y as swap, whenever the CLIST pauses for keyboard input, the user may press 
the CLEAR key to toggle back and forth between the real screen and the commentary screen. 
If no commentary screen exists, then CLEAR has no effect. When the user types real input, 
E1ZC will autpmaticaily revert to the real screen. The CLEAR key cannot be used as 
application input, except in continuous input mode. 

16) Forced swap. 2!. The CLIST can force the commentary screen to become visible with 2!. 
The CLIST then pauses till the user types ENTER. (CLEAR will re show the real screen). 

17) Fause and swap. 22. This is similar in effect to the above, except that an extra 
pause-till-enter is implied before the commentary screen is shown. This would be used when 
it was necessary to give the operator time to read the real screen before forcing the 
commentary screen. 

IS) Delay and swap. 2###. The combination 2# gives a delay of about a second before 
swapping to the commentary screen. Multiple # symbols give multiples of the deiay. No 
operator intervention is necessary. 

19) Delay. # in comment. The occurrence of # anywhere in a comment, will give a deiay of 
about a second. If the # is at the beginning of the comment, then the deiay occurs before the 
screen is cleared. This would be used with large-character displays, for instance, to ensure 
the user has time to read the screen. No operator intervention is necessary. 
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^--■tALLS AND RESTRICTIONS 

The ideal command list processor would allow any combinations of commands, statements, 
and apoiications to run, exactly as they wouic if driven by hand, unfortunately thaf = .not 
always achievable, although EXEC gets as near this aim as possible. 

i) Memory used by EXEC. EXEC requires X'600' bytes to run, olus a further X'400' if the 
commentary screen is used. If your application already fills memory you will be unable *c 
run it unaer EXEC. 

2) Memory Clearing. On Model III all of RAM will be cleared by certain programs running 
witn execute-only protection. In particular, the KILL command may dear memory, depending 
on .ne macnme state. If this happens when running under EXEC, EXEC will be destroyed, 
and the machine will reboot, or hang. The DCS command CLEAR cannot be used under EXEC. 

3) Memory-mapped incut. There is a certain class of applications which processes input not 
by using the ROM next-key routine (X'MAV) but ay examining the bits in the memory area 
wnich macs the keyccara. These will not run under EXEC, This includes full-screen editors, 
ana ward-processors. Generally the reason for usina memory-mapped incut is because the 
application needs to treat special key combinations as shifts, control keys, eiz. 

4) Pausing a display. Commands like DIR, or LIST, that produce a continuous display of more 
.nan a screenful will not be pausable under EXEC, and will not generally be usaole. 

5) ASCII bug. Although ycu can produce a BASIC program with a line which starts with a 
digit, and SAVE it correctly in ASCII, it will not reload. Instead, surround the digit with 

19 3A5IC 
23 S"2' 

33 3'4?152* 

43 etc. 

6) Timing inaccuracies. Although EXEC is recommended for driving benchmark, timincs, it will 
normally be necessary to use the continuous input cation, (2$, across the timed" zcgb, to 
avoid the effects of EXEC returning the keyboard poll. 

7) Line-end in CLISTs. Some control codes include the line-end in their definition. These are 
the single-quote comments, and the Gline-end pause prompt. The other control codes, such 
as G-r, do net "absorp" any line-ends. This can be significant to you if your CLIST - : s diving 
an application that expects precise data. E.g. 

20 PRINT X 'Comment taxi 
30 Y=i 

is equivalent, programming terms, to PRINT XY = i, whereas 

20 RUN"?RGG/BAS" 
29 S+ 
40 10.29 



resul 



1A- ;„. "■en,". 



?RDG receiving a null input line before the data 18,20. 



3) Reserved characters. The (2 and CLEAR keys are preempted by EXEC f and cannot be used 
as application data. (CLEAR can be used after <*$>. r, #, and <2 cannot be used in comments. 

13 




/ 



